home *** CD-ROM | disk | FTP | other *** search
/ Aminet 34 / Aminet 34 (2000)(Schatztruhe)[!][Dec 1999].iso / Aminet / util / sys / InstallerNG.readme < prev    next >
Encoding:
Text File  |  1999-11-06  |  13.6 KB  |  265 lines
  1. Short:        C= Installer 100% compatible replacement
  2. Author:       jt18@irz.inf.tu-dresden.de (Jens Tröger)
  3. Uploader:     htw10895@informatik.htw-dresden.de (Jens Langner)
  4. Version:      1.3 pre, Oct 08, 1999
  5. Type:         util/sys
  6. Distribution: Freeware
  7.  
  8. InstallerNG is a 100% compatible replacement of the original C= Installer provided
  9. with the old OS 3.1 releases.
  10. InstallerNG is completly written from scratch with many new features and bugfixes
  11. where the old Installer is just a pitty. Additionally, it has a formal language
  12. definition, which is the reason for a stable compiler-kernel and the good interpreter.
  13. Also InstallerNG could be the new Installer in upcoming OS release (AmigaOS v3.6+)
  14.  
  15. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  16. !!! Please note that this is a PRERELEASE and not a final version !!!
  17. !!! It could have bugs where you adviced to report them to us.    !!!
  18. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  19.  
  20. Please take a look at it and have fun...
  21.  
  22. Your InstallerNG Team,
  23.  
  24. Jens Tröger
  25. Jens Langner
  26.  
  27. Some of the new features are:
  28. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  29. - Nice GUI
  30.     The builtin-gui is based on a BOOPSI class-collection, which was also written
  31.     by Jens Tröger; these classes allow easy font-adaption, resizing and support
  32.     MagicWB. Additionally, you may "plug-in" other gui-systems (like MUI, BGui, ...)
  33.     via a shared library named "installergui.library".
  34.     Furthermore, the help window can stay open, while you install your packages;
  35.     this is a builtin feature and should be provided by every GUI
  36.  
  37. - More strict interpretation
  38.     InstallerNG is more compatible to the C= documented Installer script language.
  39.     The original C= Installer v43+ isn`t really strict in interpreting scripts and
  40.     many error are just ignored and not mentioned to the user.
  41.  
  42. - Flexible interpretation
  43.     If an error raises while the interpretation process, InstallerNG provides
  44.     to continue at the very next function.
  45.  
  46. - Interuptable Interpretation
  47.     The InstallerNG can be interupted everytime by sending the CTRL-F signal to its
  48.     process. This option allows to break out of infinite loops.
  49.  
  50. - No restrictions
  51.     The original installer has some terrible restrictions: maximum string-length,
  52.     maximum size of a string value. The InstallerNG makes none of these:
  53.     a string (and the value of a string variable too) can be as long as it fits
  54.     into your memory.
  55.  
  56. - Comfortable WB-Start
  57.     If you run the InstallerNG from WB and give it no script via tooltypes
  58.     a requester pops up which asks you whether you want to load a script by a
  59.     file-requester or if you want to app-iconify the installer. If you drop a
  60.     script-file on the application icon the InstallerNG gets started.
  61.  
  62. - Returncode
  63.     The InstallerNG now returns RETURN_OK (0) if everything of the installation
  64.     went fine, or, in case of an error, it returns RETURN_FAIL (20). This could
  65.     be useful, if you call the InstallerNG from a script and the script wants
  66.     to check whether the InstallerNG was successfull or not.
  67.  
  68. - SOOP - Simple Object Oriented Programing
  69.     With help of the new functions PUT-PROPERTY, GET-PROPERTY and REMOVE-PROPERTY the
  70.     InstallerNG implements LISP-like property-lists for symbols. Imagine of a symbol
  71.     as an object and the properties as the objects attributes. Furthermore, if you write
  72.     PROCEDURE`s, which are able to operate on an object`s attributes, you just can produce
  73.     simple OO code :)    ...without a class hierarchy, but object oriented!
  74.  
  75. - UNDO-REDO environments
  76.     Using the function "SWING" you are able to build an environment, in which you can
  77.     "swing" from one (topmost) function to the next. When reaching the last one, the
  78.     installation may proceed. This looks/works much like the MS-Setup program :)
  79.  
  80.     With v44 of the C= installer, you are able to simulate such an environment by
  81.     special TRACE/RETRACE/BACK functions (have a look at the C= installer documentation)
  82.  
  83. - Full installation control
  84.     If you want to, the InstallerNG asks for confirmation of every action, no mattter
  85.     what the script-programmer codes in his installer script
  86.  
  87. - AppWindow
  88.     InstallerNG can now act as an socalled "AppWindow", i.e. you may drop files into
  89.     the window and InstallerNG uses them. This only works, when the InstallerNG asks
  90.     for a file or directory.
  91.  
  92. ... and many more ... please see the .guide file
  93.  
  94. Changes since the last v1.2 release:
  95. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  96.     1.3 pre-release (October 8, 1999)
  97.     October 8, 1999
  98.       - fixed an enforcer-hit (caused by strtol of the amiga.lib)
  99.       - fixed a silly COMPARE bug (Kai Hofmann)
  100.       - small changes to the Install script
  101.     October 6, 1999
  102.       - ASKCHOICE/ASKOPTIONS did throw an error, if there were no evaluated CHOICES
  103.       - in case of an interpretation error: the InstallerNG executed the ONERROR
  104.         functions before the requester, so in case of an ignore, the script worked
  105.         with a cleaned-up environment
  106.       - SYMBOLSET/SYMBOLVAL did not work case-insensitive, which could cause
  107.         tricky errors (Carsten Scholling, Jens Langner)
  108.     October 5, 1999
  109.       - updated the "Known Bugs" section
  110.     October 4, 1999
  111.       - some changes to the builtin gui (Jens "Nervensäge" Langner)
  112.       - added new builtin variable @PROCEED-BUTTON for customizing the text of
  113.         the "Proceed with install"-button (Kai Hofmann)
  114.       - REBOOT supports the SAFE parameter-function
  115.     October 1, 1999
  116.       - REBOOT does not work in pretend mode (like C= Installer v44.7)
  117.     September 30, 1999
  118.       - when the InstallerNG asks for a file or dir (ASKFILE/ASKDIR functions)
  119.         you can now drop icons into its window to change the current directory
  120.     September 29, 1999
  121.       - added new function to the GUI-API
  122.       - if InstallerNG opens a custom window (see the EFFECT function), then the
  123.         different console windows open on that screen too
  124.     September 28, 1999
  125.       - added new cool example script
  126.       - the InstallerNG should now create correct logfiles (but the content
  127.         may differ from C= installer's logfiles!)
  128.     September 26, 1999
  129.       - added the logging to a custom console window (should be useful for
  130.         programming and debugging scripts)
  131.       - WELCOME: selecting a log destination did modify the user-mode!
  132.     September 23, 1999
  133.       - TOOLTYPE: if the destination icon did not contain any tooltypes, the
  134.         InstallerNG throwed an enforcer hit
  135.     September 21, 1999
  136.       - made heavy changes to the confirmation behaviour of several functions, such
  137.         that CONFIRM can now have 0/1/2 as its arguments
  138.       - the compiler should accept CONFIRM with no argument too
  139.       - STARTUP now inserts the call to 's:user-startup' into the
  140.         's:startup-sequence', if the call does not appear (currently,
  141.         only the builtin gui!)
  142.     September 20, 1999
  143.       - CONFIRM evaluates to 2 (means expert), if the argument is illegal
  144.       - when it prompted, ASKBOOL ignored the @user-level
  145.     September 15, 1999
  146.       - my installergui.library now supports dis-/enabling of the windows, the BACK
  147.         function and the HELP parameter function
  148.     September 11, 1999
  149.       - EXECUTE/REXX/RUN built the arguments in a wrong way
  150.       - GETASSIGN returned a NULL instead of an empty string, if it could not
  151.         find the related assign/volume
  152.  
  153. For more changes information, please read the .guide file attached in the archive.
  154.  
  155.  
  156. ============================= Archive contents =============================
  157.  
  158. Original  Packed Ratio    Date     Time    Name
  159. -------- ------- ----- --------- --------  -------------
  160.     2273     570 74.9% 06-Sep-99 17:38:52  InstallerNG.info
  161.     4298    1758 59.0% 08-Sep-99 11:09:08 +.LICENSE
  162.     1580     991 37.2% 06-Sep-99 17:38:50 +.LICENSE.info
  163.     2273     572 74.8% 28-Sep-99 21:47:38 +C.info
  164.   150668   61852 58.9% 08-Oct-99 16:47:06 +InstallerNG.000
  165.     1908    1049 45.0% 28-Sep-99 21:47:36 +InstallerNG.000.info
  166.   150368   61458 59.1% 08-Oct-99 16:45:10 +InstallerNG.020
  167.     1908    1050 44.9% 28-Sep-99 21:47:38 +InstallerNG.020.info
  168.   189096   74958 60.3% 08-Oct-99 16:47:34 +InstallerNG.debug
  169.     1908    1052 44.8% 28-Sep-99 21:47:38 +InstallerNG.debug.info
  170.     6834    2948 56.8% 28-Sep-99 23:07:18 +installerng.catalog
  171.    27065    8887 67.1% 07-Sep-99 17:40:34 +installerng.cd
  172.    16121    5222 67.6% 28-Sep-99 23:07:16 +installerng.cd
  173.    20382    6842 66.4% 28-Sep-99 23:07:18 +installerng.ct
  174.     2273     572 74.8% 28-Sep-99 19:02:32 +Examples.info
  175.     1994     701 64.8% 22-Jun-99 11:15:52 +math.installer
  176.     1845    1000 45.7% 28-Sep-99 19:02:32 +math.installer.info
  177.     2811     794 71.7% 24-Sep-99 11:33:16 +properties.installer
  178.     1845    1000 45.7% 28-Sep-99 19:02:32 +properties.installer.info
  179.      298     174 41.6% 22-Jun-99 11:15:40 +stringformat.installer
  180.     1869    1026 45.1% 28-Sep-99 19:02:32 +stringformat.installer.info
  181.     1041     392 62.3% 06-Aug-99 22:48:32 +sysinfo.installer
  182.     1864    1021 45.2% 28-Sep-99 19:02:32 +sysinfo.installer.info
  183.     2273     572 74.8% 06-Sep-99 17:38:50 +GUI API.info
  184.     3866    1287 66.7% 27-Aug-99 22:44:08 +igui_AskBool.c
  185.     5413    1800 66.7% 27-Aug-99 22:45:36 +igui_AskChoice.c
  186.      760     243 68.0% 27-Aug-99 22:45:44 +igui_AskDir.c
  187.     2496     803 67.8% 27-Aug-99 22:45:56 +igui_AskDisk.c
  188.      763     247 67.6% 27-Aug-99 22:46:02 +igui_AskFile.c
  189.     3166    1060 66.5% 27-Aug-99 22:46:14 +igui_AskNumber.c
  190.     4742    1541 67.5% 27-Aug-99 22:46:26 +igui_AskOptions.c
  191.     1903     629 66.9% 27-Aug-99 22:46:42 +igui_AskString.c
  192.     1470     537 63.4% 27-Aug-99 22:46:52 +igui_Bye.c
  193.      819     277 66.1% 27-Aug-99 22:46:58 +igui_ClearError.c
  194.      703     224 68.1% 27-Aug-99 22:47:04 +igui_ClearGUIEvent.c
  195.      711     231 67.5% 27-Aug-99 22:47:10 +igui_CloseCopyGauge.c
  196.      979     372 62.0% 27-Aug-99 22:47:30 +igui_Complete.c
  197.     1935     702 63.7% 27-Aug-99 22:47:42 +igui_Confirm.c
  198.     4492    1608 64.2% 28-Aug-99 09:49:58 +igui_CopyConfirm.c
  199.     3560    1163 67.3% 28-Aug-99 12:07:48 +igui_CopylibConfirm.c
  200.     5823    1663 71.4% 27-Aug-99 22:48:24 +igui_CreateFileList.c
  201.      734     237 67.7% 27-Aug-99 22:48:30 +igui_DisableCancel.c
  202.      736     238 67.6% 27-Aug-99 22:48:36 +igui_DisableProceed.c
  203.      804     252 68.6% 27-Aug-99 22:48:44 +igui_DisposeFileList.c
  204.      944     277 70.6% 27-Aug-99 22:54:58 +igui_Effect.c
  205.      912     330 63.8% 27-Aug-99 22:48:58 +igui_EmptyPanel.c
  206.     1007     370 63.2% 27-Aug-99 22:49:04 +igui_Error.c
  207.     1149     408 64.4% 27-Aug-99 22:49:16 +igui_FreeApp.c
  208.      691     215 68.8% 27-Aug-99 22:49:20 +igui_GetGUIEvent.c
  209.      631     190 69.8% 27-Aug-99 22:55:20 +igui_GetGUIInfo.c
  210.     1200     428 64.3% 27-Aug-99 22:49:44 +igui_GetNextEntry.c
  211.      686     228 66.7% 29-Sep-99 16:51:18 +igui_GetScreenName.c
  212.    20024    3604 82.0% 27-Aug-99 22:50:02 +igui_InitApp.c
  213.     1001     353 64.7% 27-Aug-99 22:50:08 +igui_Message.c
  214.      801     276 65.5% 27-Aug-99 22:50:14 +igui_NameCancel.c
  215.      804     277 65.5% 27-Aug-99 22:50:18 +igui_NameProceed.c
  216.     2243     617 72.4% 27-Aug-99 22:50:30 +igui_QueryDisplay.c
  217.     1315     450 65.7% 27-Aug-99 22:50:42 +igui_QuietWaitApp.c
  218.      983     365 62.8% 27-Aug-99 22:50:48 +igui_QuitApp.c
  219.     1054     308 70.7% 27-Aug-99 22:50:58 +igui_Request.c
  220.     1351     452 66.5% 27-Aug-99 22:51:08 +igui_SetCopyGauge.c
  221.      737     237 67.8% 27-Aug-99 22:51:14 +igui_SetHelp.c
  222.      990     358 63.8% 27-Aug-99 22:51:18 +igui_SetParseGauge.c
  223.      828     269 67.5% 28-Sep-99 18:32:32 +igui_StartupConfirm.c
  224.     1218     385 68.3% 27-Aug-99 22:51:44 +igui_SWING_Mode.c
  225.      749     230 69.2% 27-Aug-99 22:51:52 +igui_TRAP_Mode.c
  226.      705     220 68.7% 27-Aug-99 22:52:00 +igui_WaitApp.c
  227.    11633    2066 82.2% 27-Aug-99 22:52:14 +igui_Welcome.c
  228.      981     356 63.7% 27-Aug-99 22:52:22 +igui_Working.c
  229.     1346     378 71.9% 28-Aug-99 09:41:14 +includes.h
  230.      196     135 31.1% 08-Aug-99 16:51:50 +installergui_base.h
  231.     2283     828 63.7% 28-Aug-99 09:54:18 +installergui_data.h
  232.    18487    4611 75.0% 28-Aug-99 10:07:28 +libstuff.c
  233.     4374     891 79.6% 30-Sep-99 21:41:16 +installergui_protos.h
  234.     2020     602 70.1% 30-Sep-99 21:41:38 +installergui.fd
  235.     7919    2557 67.7% 03-Oct-99 21:52:38 +installergui.h
  236.     6321    1240 80.3% 28-Aug-99 10:03:00 +installergui_pragmas.h
  237.      289     199 31.1% 15-Aug-99 12:58:44 +installergui.h
  238.     2745     608 77.8% 30-Sep-99 21:42:10 +installergui_pragmas.h
  239.     3143     685 78.2% 30-Sep-99 21:42:18 +installergui_lib.h
  240.     2728    1284 52.9% 27-Aug-99 21:15:46 +README
  241.     9808    2846 70.9% 28-Sep-99 20:08:14 +savage_protos.h
  242.      208     121 41.8% 14-Aug-99 16:19:50 +filetype.h
  243.      374     123 67.1% 14-Aug-99 16:19:50 +getreg.h
  244.      515     227 55.9% 14-Aug-99 16:19:50 +guicontext.h
  245.      561     217 61.3% 14-Aug-99 16:19:50 +guicontext.i
  246.     2720     884 67.5% 14-Aug-99 16:19:50 +macros.h
  247.      153      84 45.0% 28-Sep-99 20:08:14 +patternmatcher.h
  248.      134     108 19.4% 14-Aug-99 16:19:50 +stdio.h
  249.      310     174 43.8% 14-Aug-99 16:19:50 +sysinfo.h
  250.      452     191 57.7% 14-Aug-99 16:19:50 +sysinfo.i
  251.      217     129 40.5% 14-Aug-99 16:19:50 +visible.h
  252.      399     151 62.1% 14-Aug-99 16:19:50 +visible.i
  253.    18120    6341 65.0% 14-Aug-99 16:43:12 +savage_far.lib
  254.    19012    6645 65.0% 14-Aug-99 08:27:58 +savage_near.lib
  255.    11672    2843 75.6% 08-Oct-99 16:23:28 +Install
  256.     1888    1030 45.4% 06-Sep-99 17:59:02 +Install.info
  257.   104897   31224 70.2% 08-Oct-99 16:52:50 +InstallerNG.guide
  258.     1580     992 37.2% 06-Sep-99 17:39:06 +InstallerNG.guide.info
  259.     2273     569 74.9% 06-Sep-99 17:38:52 +Libs.info
  260.    28500   12131 57.4% 04-Oct-99 11:39:58 +installergui.library
  261.      268     233 13.0% 03-Oct-98 11:43:14 +CloseScreenPatch
  262.     2272    1460 35.7% 27-Mar-99 08:26:48 +GetSum
  263. -------- ------- ----- --------- --------
  264.   953491  347585 63.5% 14-Oct-99 17:26:36   103 files
  265.